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Last word trademarked 

Computer industry executives say that new product introductions will be 
more difficult but that somehow they'll cope with the U.S. trademark office's 
mid-June announcement that every word in the English language has now 
been trademarked. As recently as ten years ago, trademark experts 
estimated that the supply of untrademarked words would last well into the 
22nd century; however, that was before the full impact of the personal 
computer revolution was known. Computer products alone have accounted 
for more than 90 per cent of ail trademarks issued during the last five years, 
the trademark office reports. 

The last English word to be trademarked was "alack." It will grace a new 
MS-DOS spreadsheet program. "We would have preferred a different word," 
said Jim McOlinn, a spokesman for the program's publisher, "but it was the 
last word left. Since Alack almost has all the letters needed to spell calc,' we 
decided to take it while we had the chance" 

Trademark experts say companies have only three options left in naming 
new products. One is to make up newwords. Experts say thtsoption is getting 
veiy tiresome, however, because all the pronounceable combinations of 
four-, five-, and six-lette rs have already been used. 

The second option is to use foreign words. This is apparently the strategy 
Apple's new software company (see our June issue, page 3.37) will take in 
renaming AppleWorks and Apple Writer. Sources close to the company, who 
asked not to be iden tified, said plans are underway to add a Sanskritic suffix 
to all the company's program titles. Tor example, AppleWorks and Apple 
Writer are expected to be re-released as HforfcsH&Iaand WriterWala. Apple's 
trademark lawyers were reportedly in Bombay at the end of June trying to 
license Asian rights to the suffix from the Bata Rickshaw Company, 

The third option is to share a product name with another company, which Is 
a possibility only In cases where it is unlikely that there will be any confusion 
in the marketplace over what is what for example. Heinz 57 has reportedly 
licensed all of It pickle and mustard trademarks to Lotus and Ashton-Tate. 
Microsoft is known to be negotiating with Oldsmobile for the right to name 
the operating system ifs developing for IBM's new computers after the Jetiire 
Rocket 88. And Borden has sold Aldus the rights to Elsie the Cow. 

(Trade sources report Aldus will use the trademark for a new desktop dairy 
program for the Mac II. This will be the first in a series of desktop 
manufacturing programs from Aldus, which will be based on a top-secret 
Apple product to be called the LaserMaker, which is itself based on the Mazda 
rotary engine, This machine is rumored to be able to manufacture any object 
that can be drawn on the Mac II screen. Elsie and the LaserMaker will be 
introduced by Aldus and Apple, confidential sources say, as soon as Apple 
and Mazda can get a slight aftertaste of Napa valley Rose' out of the 
machine's milk.) 

Closer to home, we've found two products you might be interested in that 
are both called "Softswitch." One is a software product from Roger Wagner 
Publishing that turns a 51 2K Apple I Igs into three 128K Apple lies. The other 
is a box that allows you to plug four printers into one serial port and switch 
between them by sending a control code to the box. 

Roger Wagner Publishing/* Softswitch, which was written by Ken 
Kashmarek, has been running flawlessly on my Apple llgs since a few hours 
after the UPS man delivered it This SoftSwitch is a desk accessory that 
appears In the control/open-apple/e scape menu along with the Control 
Panel and whatever other desk accessories you've put there, SoftSwIteh gives 
you three "workspaces" for saving the current status of ProDOS 8 (or DOS 3,3 
or Apple Pascal or any combination) programs. You can switch between 



workspaces with just a few keystrokes. When you return to a program, it is 
exactly where you left It You can actually leave Applesoft in mid-beep as it 
punishes you for a syntax error and return hours later to hear the rest of the 
beep. 

The most obvious use for Softswitch is to switch between, for example, 
AppleWorks and other programs that offer Features not in AppleWorks, such 
as communications or graphics programs. In this use, SoftSwitch becomes 
sort of an expanded open-apple-Q(uick Change) command. Or use it to 
switch between a word processor, an assembler, and Applesoft Or use it to 
demonstrate the differences among WsiCafc. the AppleWorks spreadsheet 
and 5uperCafc3a 

You can also use it to revert to a previous program state. For example, just 
before you decide to descend a dark staircase In a new adventure game, you 
can tell Softswitch to save the current program state. Ifyou get eaten alive at 
the bottom of the staircase, SoftSwitch can restart you at the top for a go in 
another direction. 

So/tSujitch can allow several users to share one machine. You can save 
your application in a workspace and let another person have the computer. 
When the other person is finished, your application can be restored instantly, 
at the exact point where it was Interrupted. 

SoftSwitch also has a provision for cutting and pasting any single- or 
double-resolution graphic image from one program to another. It doesn't 
matter whether one of the programs is protected or whether the programs 
run under different operating systems. All that's necessary is that the 
programs use standard Apple gra phics and that they allow access to the desk 
accessory menu. Thus, if one of your workspaces holds a graphic printing 
program such as Beagle Bros Triple Dump or Roger Wagner's own 
Printographer, you can capture a high-res image from almost any program at 
any time and print it SoftSwitch can also save text displays — th us providing 
a way to take "screen shots" for use in printed material. 
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Keepsake is a separate program supplied with Softswitch that allows you 
to save the program currently stored in any workspace to disk. Using 
fteepsafce, you tan suspend a program's operation over any period of time. 
Or you can compare an image of a program before it crashed to an image 
after it crashed to see where the changes are. 

There are a couple of small things i don't like about Softswitch. One is that 
ifs a ProDOS 16 program. This means you have to boot a ProDOS 16 system 
disk to install Softswitch in the desk accessory menu. Using an Apple 3.5 
drive, this takes 25 seconds. This isn't SoftSwitch's fault of course, but the 
fault of ProDOS 16 and the (chug-a-chug) System Loader. So I called Wagner 
and asked him why Softswitch wasn't a ProDOS 8 program. 

He said that every time ProDOS 16 is booted, it removes all existing desk 
accessories. If So/tSwitc/t was a ProDOS 8 program, then you couldn't get 
into a ProDOS 16 application without destroying Softswitch and losing your 
workspaces. Instead, SoftSuiifcft was designed so that ProDOS 16 would 
already be booted by the time you got to So/fSuiitcfi You can use the active 
Softswitch workspace to "launch" or "run" (but not "boot") a ProDOS 16 
application. So/tSuutefc can be used to capture screen images while the 
ProDOS 16 application is running, but for nothing else. After the ProDOS 16 
application ends, however, the full powers of Softswitch return and the 
contents of all three saved workspaces are intact. 

Why won't Softswitch work with ProDOS 16 applications? Wagner says the 
primary probl em is that currently, almost all ProDOS 16 applications "don't 
behave." They use memory areas that are off-limits, they disconnect the 
control-panel, or they puD other tricks that make switching impossible, Once 
ProDOS 16 programs have developed predictable behavior patterns, Wagner 
expects to have a So/tSicitch update. Oh, and guess what AppleWorks 2.0 
and the Apple Jigs System Utilities misbehave, too. (You can always depend 
on Apple's own software being first in line when it comes to not following 
compatibility rules.) You can run AppleWorks 2.0 in one workspace without 
problems, but don't try to run it in two of them or try to "revert" to an earlier 
program status. Earlier versions of AppleWorks cause no problems. Here's a 
little editorial from the Softswitch manual about this stuff: 

Softswitch works very nicely with programs that foilow the Apple 
design guidelines for software. These guidelines were put together by 
Apple to encourage software publishes to create software that is easy for 
everyone to use. 

Software that doesn't follow these guidelines makes life harder for 
everyone. Here are things in particular that Softswitch doesn't like: 

lj No QUIT command, orquit reboots instead of returning to the program 
selector. 

2.) Erasing all of memory when quitting. 
3 J Disabling the Desk Accessory Menu. 

4. ) Incompatibility with Desk Accessories; ie.. access may be allowed, 
but the program crashes on return from the Desk Accessory menu. 

5. ) Hi-Res (or Double Hi-Res) images not stored on normal graphics 
screens, and/or are encoded in a non-standard format 

If you have programs that have these kinds of problems, write the 
publishers and tell them you want your software to work for you, not 
against you! Of course they want your opinion— they gave you that nice 
registration card and asked for It, remember! 

So, if you're using software, let other people know what you want; if 
you're writing software, take a little time to make things easier for 
everyone. 

If you analyze the problems listed above, youU note they are almost all 
related to copy protection. Which brings up the second thing 1 don't like 
about So/lSuiitch-its somewhat copy protected. You get an uncopyable 
IliSTALL disk, which is used to place Softswitch on ProDOS 16 system disks. 
These disks, at least are fully copyable-but the So/tSiuitch program file 
doesn't show up where you'd expect in the catalog. Rather than being in 
SYSTEM/DESKACCS/SOFTSWTTCH Its called SYSTEM/SYSTEM.SETUP/ 
TOOLSETUP.2. When you send in your registration card, tell Wagneryou want 
your software to work for you, not against you. 

Roger Wagner Publishing is selling So/tSwitehfor $59.95. Its available now. 
(1050 Pioneer Way, Suite P, El Cajon, CA 92020 619-442-0522). 

The other Soft-Switch (note hyphen) is a possible solution to the 
pervasive out-of-slots problem. This Soft-Switch is a box with one RS-232 
serial input and four parallel outputs. It allows you to connect four parallel 
printers to a single serial port Unlike other devices of this kind I've seen, 
which require you to rum a knob to change printers, Soft-Switch lets you 
change by sending the box a control-E, followed by a number between 1 and 



4. With AppleWorks, for example, you'd just add "control-E 1" to the interface 
card code for printer X "control-E 2" to the code for printer 2, and so on, A 
program can also change printers and return the box to its previous setting, 
without actually knowing what that setting was, by requesting printer 5 when 
it has finished printing. 

This Soft-Switch costs $199 and is manufactured just across the Kawfrom 
us by Intronics, P.O. Box 13723, Edwardsville, KS 66113 913-422-2094. 
Intronics also makes parallel-to-serial and serial-to-parallel converters that 
sell for $65. The Soft-Switch was originally designed to allow institutional 
computers to print several kinds of continuous forms (invoices, packing 
slips, and UPS tags, for example) out in the warehouse on cheap printers, but 
I'm sure there are people in the Apple 11 kingdom who could put such a device 
to good use too. 

Back in 1980, in the heyday of the Apple II Plus, the high-end data 
base program for the Apple II was probably Stoneware's DB Master. 

After a fewyears of success, the company began a long, slow fade that ended 
when it closed its doors last summer. 

Stoneware the company was started by a fellow named Barney Stone. Soon 
after he started it he sold it then he and some co-authors developed DB 
Waster, which Stoneware obligingly published. After Stoneware disbanded, 
the rights to DB Master were acquired by Stone Edge Technologies, a 
company made up of Stone and his co-authors. They have since been busy 
on a total rewrite of the program, which is now available as DB Master Version 
Five. This new, ProDOS-based version of DB Master allows 200 fields-per- 
record and up to 250 characters-per-field (with a 2,000 character-per-recorrJ 
limit). Each record can have as many as 30 screens. The program will use up 
to 40 megabytes-per-file on a ProDOS-compatible hard disk, or up to 50 
disks (5,25, 3.5, or mixed). In addition. Stone is working on a "Professional" 
version, which he expects have ready by fall, that will bring a multi-file 
relational capability (along the lines of what I wrote about here last montii) to 
the Apple It 

The differences between DBWasterand the AppleWorks data base lie along 
the lines of speed, power, and capacity. Since AppleWorks stores all records 
in memory while a file is being worked on, it will always be faster than DB 
Master. Since DB Master stores all records on disks, on the other hand, it can 
deal with many more records, which can be larger than what AppleWorks 
allows. Like AppleWorks, DB Master Version Five is written entirely in 
assembly language (and requires an enhanced lle,a Hcora Hgs),so theonly 
thing that will slow DB Waster down will be the speed of disk access. 

One area where the power of DB Waster tends to blow AppleVfcrks away is 
in report generation. Where AppleWorks allows you to set up only table-style 
or 15-line maximum label-style reports, DB Master's report generator allows 
the same easy set up as AppleWorks but includes multi-page "invoice-style" 
(free-form) reports as well. It allows field-by-field control over print style and 
field formatting. You can include your own text in your reports, such as 
commas between city and state (or even an entire letter for mail merge), 
which AppleWorks won't allow. Each report has four specification screens- 
one each for sort, selection, printer, and layout 

Stone says that he wants to make DB Wasterattractive toAppIeWorks users 
and that he wants it to be the high-end data base program in the Apple H 
market Version five is available for $179, the Professional version is expected 
to be priced at $295. One year of technical support including free, automatic 
upgrades, is $75 for version five and is expected to be $100 for the 
Professional version. Upgrades for current DB Waster owners are available. 
For more information, contact Stone Edge Technologies at P.O. Box 200, 
Maple Glen, PA 19002 215-641-1625. 

IVe learned some interesting tacts about the U.S. telephone 
system lately that may be of use to some of you. My wife is a research 
psychologist and she's been spendinga lot of time the last few months hiding 
out at home analyzing data on a mainframe computer at work. At our end 
she has an Apple JIe,a 1200-baud modem, and ASC// Express set uptomake 
the mainframe think she's working on an ADM terminal. 

She was happy with this system The only problem was that 1 couldn't use 
the phone for hours at a time. And people trying to call us would encounter a 
continuous busy signal. So 1 decided to have a second phone line put in. 
However, 1 was quite concerned about the time and work It would take to run 
hidden wires from the phone company's "network connection" on the 
outside of the house to all the places 1 wanted the second line to be available. 

That's when I started to investigate something that has always puzzled me. 
Why do telephone people always talk about their cables being "twisted pair 1 / 
when, in fact there are fourwires inside most telephone cables? It turns out 
that telephones really do use only two wires (the red one and the green one). 
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The other two wires {the yellow one and the black one) were added 10 or 20 
years ago to provide lowvoltage power to phones with lights in them or other 
special features. Most homes, however, don't use these wires for anything. 
You can hook your second phone line to them and immediatery have the 
second line available at every existing phone jack in your house. 

Before proceeding, get a multimeter and attach it to the yellow and black 
wires to make sure there is no voltage on them. The person who lived in the 
house before you may have had a phone with lights— the transformer that 
kept them lit may still be attached. I f there's no voltage, check to make sure 
that there's plenty of resistance as well — if there's not, it probably means the 
yellow and black wires are twisted together inside one or more of your jack 
housings. 

After the wires pass both of these tests, attach your second line's red wire to 
your home's yellow wires and the second line's green wire to your home's 
black wires. Next go down to your local Radio Shack store and look over their 
selection of "two-line modular jacks." These are little conversion plugs that 
you stick into your existing phone outlets (at the wall) that give you two or 
more outlets to ptugyour phones and modems into. Radio Shack even sells 
two-line telephones that expect your second line to be on the black and 
yellow wires. 

now my wife's modem is plugged into our second line and she can use the 
mainframe all day while my 10-year-ofd daughter's friends can call in on the 




first line with nary a busy signal. My wife can even call up the mainframe 
technicians and complain about the speed of their computer without logging 
off. 

I also have my old Integer Basic Apple II and my circa 1980 Hayes 
Micromodem hooked into the second line. It answers the phone in the 
middle of the night when Open-Apples 800-number answering service 
wants to dump records of the previous day's calls (see last month's page 3.35 
for more details). Their computer thinks my old II is a remote printer, but I 
won't tell if you don't If any of you would like to dump something into my 
"remote printer;' the number is 913-383-3203 (300 baud, 8N1 half-duplex). 
Don't expect it to say hello to you or anything, however, just call in and start 
sending something. The II will save your message on a disk and 111 find it and 
put it in one of the piles around here the next morning. 

Incidentally, if you think its too expensive to send text by long- 
distance, check out AT&T's "Reach Out America" rates. If you sign up for 
this plan you'll be billed a minimum of $8.40 a month. This covers one-hour 
of long distance (any number of calls) anywhere in the U.S. outside of your 
own state. Calls must be made at night, between 10 pm (not 11 as with 
standard night rates) and 8 am, or between 10 pm Friday night and 5 pm 
Sunday evening. Additional hours are billed, in minutes, at a rate of $755 per 
hour. With rates like these ifs becoming cheaper to call local bulletin boards 
all over the country than to use the national information services. Other long 
distance companies may offer even better deals. For more information on 
AT&T's rates, call 800-225-5288. 

Do you remember a program called TKlSoluef? It was originally 
published by Software Arts, the company that developed VisiCalc, and it sold 
for $395. Ifs an equation solver that can provide answers to problems with 
several unknown variables. Ifs a classic program that has always been highly 
regarded by people who need to solve such equations. 

Meanwhile, Software Arts got into a emotional sink with VisiCorp, the 
publisher of VisiCalc and the two companies choked each other to death. 
Software Arf s assets were purchased by Lotus, and Lotus later sold all rights 
to TtQSolver to a company called Universal Technical Systems, Universal 
updated the program to version 16, took off the copy protection, and is 
selling an Apple II version for *99 (1220 Rock St Rockfcrd, IL 61101 800- 
435-7887). If you're into iteration or consecutive substitution this one 
should be in your library. 



novation is a company that has been making modems since the 
days of teletype terminals. They have just announced a $119, 300/1.200- 
baud, Hayes-compatible, stand-alone modem that's about the size of an 
audio cassette (smaller than the "microcouptef on old Hayes Micromodems, 
for those of you who have been around awhile). It doesn't even have a power 
supply -it gets all the juice it needs from the R5232 serial interface. They 
call it the Parrot 1200. Pretty soon modems are going to be cheaper than the 
cables you need to connect them to your com purer. 

I've seen pictures of the ultimate LEGO set and I sure wish the price 
was closer to what Santa Claus can afford. LEOOs, for those of you out of 
touch with the world of children, are building blocks. The ultimate LEGO set 
comes with a version of the Logo language on disk (talk about shared 
trademarks), a card that fits in a tie or llgs slot, an interface box, 2 motors. 1 
optical sensor with counting disk, 2 touch sensors, 4 light bricks, and more 
th a n 400 other special pieces for building interesting machines that can be 
controlled by your Apple II. The brochure for this set makes me drool. The 
price, however ($450) makes me wince, lb get your brochure talk to: Sarah 
McDonald, Education Dept LEGO Systems, 555 Taylor Rd, Enfield, CT 06082, 
800-243-4870, 203-749-2291 

Open-Apple subscribers are a creative and hard-working bunch, 

and several of them have come up with stuff they want the rest of you to know 
about 

Pathfinder is a $20 enhancement for the U.S. version of AppleWDrks 2.0 
that replaces the "Format a blank disk" option on AppleWorks' Other 
Activities menu with commands that allow you to specify subdirectories by 
pointing at them and pressing return rather than by typing them in. This is 
how AppleWorks should access subdirectories at every point that it presents 
a disk catalog, but doesn't PathFlnder was written by Randy Brandt— the 
same Randy Brandt who wrote Beagle Bros' Super MacroHbrfcs. He is selling 
Pathfinder himself, however, through a company he calls JEM Software, P.O. 
Box 20920, El Cajon, CA 92021 One of my favorite parts of the product is the 
warranty. Right underneath Apple's standard California-lawyer ProDOS 
warranty it says, "Like ProDOS, this product is basically useless and you're left 
holding the bag if anything goes wrong Some states disagree, in which case 
you're exempt" 

The Periodical Index from T-Squared Enterprises was described here 
previously in November 1986, page 2.74. T-Squared's indexes are self- 
contained, meaning each disk contains both data and the program to search 
the data with. Indexes to the 1985 and 1986 issues of Open-Apple are now 
available for $5 each. Previous purchasers of the 1985 index willautomatically 
get both the 1985 and 1986 indexes on a single disk (1015 S Ridge Ave, 
Arlington Heights, IL 60005, 312-577-7381 add $3 for orders outside the 
U.S.). 

The Magazine Index from Kula Software is much broader in scope than the 
index from T-Squared, with proportionately less detail. Kula's index covers 
not just Open-Apple, but all the Apple II publications we get around here 
plus a few more I've never seen. Another interesting feature of Kula's index is 
that ifs distributed as a set of AppleWorks data base files. The 1986 disk has 
an introductory price of $5 — earlier years are also available 12116 rvula St, 
Honolulu, HI 96817, 808-595-8131). 

Peter Meyer, author of Pinpoinfs InfoMerge, solved the "read an AppleWtorks 
data base file" problem that I discussed here in March (pages 3.9 to 312) with 
an ampersand routine capable of making ProDOS MLI (machine language 
interface) calls. Meyer and an Applesoft program that uses these routines to 
read an AppleWorks data base file of any size can be separated for $5. If 
there's enough interest Meyer will make available the complete Applesoft- 
ML1 interface routine (P.O. Box 1001. Captain Cook, HI 96704). 

Robert Moore has an assembly language routine called IHPUTPRiriTQET 
that he will share with anyone who sends him a disk and a stamped, self- 
addressed disk mailer. The program adds three ampersand commands to 
Applesoft, &INPL1T x$, SPRINT x$, and 8fGET x$. The commands behave 
much as the similar commands in SU2.0BJ do (see December 1985, page 
96; March 1986, pages 2.13-14; and May 1986, page 2J52 for the complete 
details on SU2.0BJ). Moore provides his routine in both object code and 
heavily commented source code. The source code illustrates how to install 
machine language routines above H1MEM in both DOS 3.3 and ProDOS, how 
to chain into the am persand hook, how to read the value of an Applesoft real 
variable from machine language, how to set the value of an Applesoft string 
or real variable from machine language, and howto use software "switches" 
and "signatures" to obtain multiple functions out of a single module of code 
(1204 Marton Street Laurel, MD 20707). 
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The AppleWorks machine 

All right, so 1 finally broke down and bought Apple- 
Works after reading so much about its virtues in your 
publication. I didn't want to shell out the 250 bucks 
when I bought the lie but I see the light now. | thought 
I could get by with Apple Writer and PFS:File, a Pascal 
program that by comparison seems slow, inflexible, 
and difficult towork with, especially in printer applica- 
tions. AppleWorks sorts in the blink of an eye, is very 
flexible and forgiving, and is not nearly so disk- 
intensive. Print criteria such as margin settings are 
saved with the file and Apple Writer doesn't do that. 

I'm only beginning with it, but 1 have already used it 
to submit a proposal concerning a new warehouse 
facility our company is building. The ability to merge 
database and spreadsheet reports with the word 
processor has opened new worlds for me And the 
final document looks smarter than I do sometimes. 
So hey, all you out there with an Apple II, if you don't 
have AppleHforks, buy it! To think of someone else 
wasting all the time I did creating all those Pascal files 
drives me crazy. 

By the way, would AppleWorks use the disk less if I 
had my lie upgraded to 256K? What I have is version 
2,0 running in 1 28K. It has to access the disk on a lot 
of open-apple commands and I don't think it should 

hareto - Harry Barr 

Dayton, Ohio 

It's race to occasionally see the world through 
fresh eyes. Dermis and I enjoyed reading your letter. 
But you, my friend, ain't seen nothin yet for the 
record, here's the kind of enhancements you should 
consider adding to your system: 

Memory expansion. Get yourcomputers memory 
expanded to 5 12K or more and you won't be able to 
understand why people buy IBM-PCs. In the lie and 
lie worldyou'Uhave to choose between an "aux-slor" 
card —such as Applied Engineering's RamWorks (lie) 
or Checkmate Technology's AfuiiuWf (lie and ile 
versions) -or a standard-slot" card - such as Applied 
Engineering's (iamfactor (any slotted 11), Ciitech's 
ptusRAM (any slotted 11), or Apple's own memory 
cards (slot and lie uersionsj. The aux-sfot cards are 
based on an older technology that's starting to fade, 
b ut they come with AppleWorks expansion software 
that's better than what you can get with the standard- 
slot cards. It's a tough choice. I lean slightly toward 
the standard-slot cards because they're more Ukeiy 
to be supporter] by future software. 

People in the llgs world, on the other hand, should 
startwUh a card that fits Into the spedal llgs memory 
expansion slot (If you also have a ll-Pius/lle standard- 
slot card, you can plug that into the llgs too, but Us 
memory doesn't become part of the directly- 
addressable Hgs memory. It can stilt do anything it 



does on any other II, however. Aux-slot cards are 
good for nothing but a cheap source of memory 
chips on a llgs.) 

The aux-siot cards come with software that modifies 
Applelinks so that it uses the memory on the card 
for an expanded desktop; so that it allows more 
database records, word processor lines, and spread- 
sheet cells; and so that it loads itself onto the 
memory card. Virgin AppleWorks 13 automatically 
does most of this same stuff on standard-slot cards 
(the amount of database-word processor spreadsheet 
expansion isn't as great as with the awe-slot software, 
however). Virgin AppleWorks 2.0 automatically does 
this same stuff on both standard-slot and llgs memory 
cards (ditto). 

It all means that once you start up AppleWorks with 
one of these cards in place, you will have a desktop 
with a lot more room for files andyouH have no disk 
access at all e*cept when you print (the SEG.PR file 
typically isn't loaded into memory). However, if you 
fill the desktop so full of files that there's not enough 
room left for the AppleWorks program itself, Apple- 
Works automatically goes back to getting program 
segments from the disk. 

If you want to save some money, buy your card 
with the minimum amount of memory and plug In 
the maximum number of BAH chips yourself. For a 
good source of chips, see my introduction to the May 
198 7 letters, page 3.50. The price difference will buy 
you at least a couple year's worth of Open-Apples. 
For a rundown on the differences between the 
standard-slot cards that are available, see my response 
to "Auxmem corrections and more" in the January 
1967 Open-Apple, page 2.93. 

tlighcrcapacity disk drives. Once you get Apple- 
Works expanded, you may developa need for higher- 
capacity disk driues. Using AppleWorks with one of 
Apple's own memory cards, in fact you can create 
files that are too large to save onto your disks. (The 
expansion software that comes with third-party 
cards will automatically "segment" a large fUe so 
that it can be saued onto seuerai floppies. Apple Works 
without third-party expansion enhancements can't 
do that) 

Apple's UnlDisk 3.5 is an expensive BOOK choice 
that works on any Apple II. Central Point Software 
sells less expensive. 5.5 inch drives for slotted Us, 
howeuer, we haue .seuerai subscribers who couldn't 
get the Central Point drives to work with their 
systems and who sent them back. My guess so far is 
that these drives consume more power than Apple's 
drives and thus have a greater tendency to make 
systems that are already loaded down with memory 
cards and other goodies act flakey. It's just a guess 
though. 

If you need even larger disk drives, there are 
several kinds of hard disks available for slotted lis, 
and at least one for the lie. In general, howeuer, / 
recommend auoiding hard driues unless you can 
write a 10-page proposal demonstrating that you 
really need that much capacity on line aU at once. 
See "Cheap hard drive alternatives" in our November 
1986 issue, page 2. 76, and "RamFactorashard disk" 
in our December 1986 issue, page 2. 86, for more on 
this. 

Vnintenuptable power supplies, now thatyou 
have 750H bytes of work on your desktop and 
maybe even a 20 megabyte hard disk to save it all 
on, what are you going to do if the lights go out? 
Lose all that data and lei your hard disk's head 
crash? See "Reviewer's Comer" in our January 1986 
issue, page 198, for an answer to this problem. 



Since that review was written, incidentally, Kansas 
Oty Power and Light has lost more than a few 
electrons, but I haven't lost a single byte of data. 

Accelerators, flow you've expanded memory 
and disk capacity, but Apple Worksis starting to seem 
a bit "stow" when you're working with large files. If 
you have a lie or older 11, you can get an accelerator 
card to speed things up. Our favorite accelerator 
around here Is still Applied Engineering's TransVforp, 
though, like Central Point's drives, it can make your 
system do strange things if your power supply is 
working near or beyond Us capacity, lie owners, 
unfortunately, are out of luck when it comes to 
accelerators, llgs owners have one that's almost as 
good as the TmnsWarp built right into their machines. 

Macro programs, flow your appetite is really 
whetted, flow about some software that enhances 
AppfeHbrfcs so that you can press solid-apple plus 
one other key and see your entire name and address 
appear on th e screen ? Or see the cursor immediately 
Jump to the screen's right or left edge? Or see a 
report printed without choosing a printer, specifying 
the number of copies, or even saying "yes ? 

The macro program I use everyday Is Auto Works 
from The Software Touch, It includes a very nice 
mail-merge feature and does everything else 1 need 
a macro program to do. ffoweuer, if you'd (ike to 
actually write AppleWorks programs" that other 
people can run, you should get Super Macro Wo rks 
from Beagle Bros. It is nothing less than a program- 
ming language for AppleWorks 2.0. On the other 
hand, those of you who have a need for pop-up desk 
accessories such as an appointment catendar, a 
telephone dialer, a calculator, a communications 
program, or a spelling checker should look at Pin- 
point's Keg Flayer. It's a macro program that's 
compatible with Pinpoint's other desk accessories. 

Desk accessories. Pinpoint seems to have run 
away with this field. Desk accessories are small 
auxiliary programs that you can run without leading 
AppleWorks. Pinpoint has a good selection of such 
programs. However, they don't exactly "pop" until 
you have a memory card to store them en. An 
accelerator helps too, especially with the spelling 
checker. But once you've got all that other stuff, 
adding Pinpoint will make your I HM friends wave the 
white flag, 

In summary, we spend so much space here in 
Open-Apple talking about the bugs in and the 
limitations of AppleWorks that sometimes we forget 
how muchU does do, how easily it does it, and how 
far its limits can be pushed. If it wasn't so important 
to all of us we wouldn't spend nearly so much space 
talking about it. 

Bugs, limitations, and explanations 

I'm having trouble running AppleWorks 2.0 with 
Applied Engineering's AppleWorks 2.0 expander (V 
13) on my llgs. I can boot AppleWorks once, but if 1 try 
to reboot it or even restart it it loads to the getting 
started screen and then dies, nothing but turning the 
llgs power off for a couple of minutes will get me back 
to the program. Applied Engineering's technical 
support could offer no help. Is there any advice you 
can offer? 

Michael CoMlle 
Del Norte, Colo. 

ft sowids to me like AppleWorks or the expansion 
software is having trouble allocating memory, perhaps 
because one or the other doesn't dean up after itself 
when you leave AppleWorks the first time. It is 
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particularly Important on the Ilgs to let programs 
clean up after themselves, so always use a Itgs 
program's quit option. Are you running another 
program after Apple Works that is causing the problem? 
Do we have anyone else who has experienced this? 

Recently, we have been unable to save AppleWorKs 
2.0 files to 3.5 disks. This happens whether we are 
saving directly bom the document or using the save 
command in the main menu. 

Marianne Harding 
Washington, DC 

A local dealer says a user reported the same 
problem with 600K of disk space remaining. One 
barrier you may be running into Is that ofProDOS's 
Omit of 51 files in a disk's main directory. If you're 
using subdirectories, we don't know whatthe problem 
is. Do we haoe anyone else who has experienced 
this? 

I think 1 have (bund a new bug while using Apple- 
Works 2 0, It seems that AppleWorks 2.0 will not 
handlesubdirectories with more than 64 filenames in 
any given subdirectory. 

FritzAWonnacott 
Goaanda.riY 

Dennis created a subdirectory with 100 empty 
AW? files named AW.TEST.000 through AW.TEST.100 
and told jlppieHorfcs he wanted to add a file from this 
subdirectory. First he saw a message that said: 

RppleWorl<s will list only the 
First 130 filES on this disk. 

Then he pressed "space" to continue. jlppIeMforfcs 
2.0 displayed the first 85. AppleWorks 12 showed 
him ail 100. We cannot account for any of these 
numbers. Cananyone else? 

I encounter problems with the AppleWorks 2.0 
patch from Applied Engineering, from within the 
report format menu there happen strange things 
when you try to move a field up or downwards. The 
field not only relocates, but stays on the same place 
as well. 1 tried the standard AppleWorks 2.0 and had 
none of these problems. 

Jack van Soest 
Vlaardingen, The Netherlands 

I've seen mis happen with AppleWorks 2.0 and I 
don't liave Applied Engineering's 2.0 expansion 
software, so I don't think they're to blame, lias 
anyone else isolated this problem? 

I am usinga 1 meg Ramfactor with battery back-up 
plus AppleWorks 1.5. You described the card in the 
January Open-Apple, page 2.93. AppleWark's habit 
of taking possession of all available memory for its 
SYS.DESKTOP file makes it impossible for me to save 
a data file on the RamFactor. I tried creating dummy 
files and deleting them as you suggested, but I have 
to delete one every time I start up AppleWorks and 
they are used up very quickly. It would be really nice to 
find a way of restricting the SYS.DESftTOP file to a 
preset value, like 300K. You also mentioned creating 
a special partition Just for SYS.DESKTOP in January, 
but how? 

Alexander Buchholz 
Mainz, West Germany 

The only solution me can figure out is to write an 
Applesoft "pre-boot" program that saves a dummy 
file in the partition before you start up AppleWorks, 



Then you can delete that file from within AppleWorks 
to reclaim some space on the RamFactor for your 
dataflles.WeagreethatthewayAppleWorkshogsall 
available memory is no good. Another bad example 
appears IfyoustartupAppleWorkslOinaSoftSwiich 
workspace on a Ilgs. AppleWorks wiS. take over all 
the memory in the Ilgs. It won't leave anything for 
the other Softswitch workspaces. Thus, to use 
AppleWorks 2.0 with Softswitch you have to start it 
up last, after you already have the other memory 
you need. AppleWorks should provide someway for 
users to specify the maximum amount of memory it 
can use, but doesn't Our January suggestion of 
creating a special partition just for SYS.DESKTOP 
was based onan editing misunderstanding, I thought 
that you could have two active ProDOS volumes on a 
RamFactor, but Dennis tells me that isn't true. The 
RamFactor looks like too 400K disks to DOS 5.3, but 
other operating systems can see only one disk when 
loosing at the RamFactor. 

A colleague lostan AppleWorks 2.0 spreadsheet file 
during a save to an almost full disk, No error was 
reported, but she ended up with a directory entry 
showing a 9 block file and a file index block pointing 
to only one data block. Whenever she hied to load the 
file, Appl eworks 2.0 dropped into the Monitor. Ouch! I 
managed to find all the parts of the lost file using 
MR.FTXTT from the ProSel disk. It showed seven used 
blocks in the volume bitmap that were not owned by 
any files. 1 figured out the order they should be in by 
looking at them with BLOCRWARDEtt (also on the 
ProSel disk) and then patched the file index block and 
the file directory enoy to recover the file. 

Jim Luther 
Kansas City, Mo, 

Releasing the power 

Can you tell me about the Apple power supply? In a 
catalog I read that it's rated at 2.5 amps. In my lie's 
slots I have devices that are pulling 21-2.4 amps, 
based on the catalog's estimates. I'd like to buy some 
more cards that will pulJ another .9-21 amps. Are the 
cards still drawing current if they are installed in the 
Apple but not active? Am I in danger of overloading 
my Apple? lfso,what are my alternatives? 

Robert Albani to 
Chicago, 111. 

(For those of you who are new around here, here's 
some essential background Information. The "power 
supply" is the large metal boxyoull find inside your 
slotted II. It converts a range of AC voltages into four 
specific DC voltages. On the 7/-P!us and lie it is held in 
place by four screws you can access from the 
bottom of the computer. On the Ilgs it just kind of 
snaps In and out. Replacing a power supply is only 
slightly harder than changing a light bulb and 
considerably easier than hooking up a video cassette 
recorder. The "power supply" we're talking about 
here is totally unrelated to the "\inlnterruptable 
power supply" I talked about earlier, which is a 
larger box with a battery inside thai goes between 
your wail outlet and your computer and keeps the 
AC juice flowing to your computer for 20 minutes or 
so after a power failure.) 

Some cards, memory cards for example, draw the 
same amount of current whether they're active or 
not. Other cards, disk drive controllers, for example, 
can pull far more current when they're active than 
when they're inactive. 

Are you in danger of overloading your Apple? Our 
answer is a clear "yes." Unfortunately, the symptoms 



of an overloaded Apple aren't at all clear. It doesn't 
just start smoking or blow a fuse or something easy 
like thai Typically the computer starts doing such 
things as erasing Track on your floppy disks or 
putting strange characters on yourscreen or locking 
up at inopportune moments. The problem is oflen 
fixed" by remouingafficely card from your computer 
and heaping blame and disgusl on that card for all 
the trouble you've been having. Applied Engineering's 

two power-hungry cards that often end up in the 
cross fire. 

For some background reading, see "Power Supplies 
and Track 0" in our Way 1986 issue, page 2.29, 
"Users battle technical support"in our January 1987 
issue, page 2.96, and "More Trans Warp experiences" 
in March 1987, page 5J3. In my response to the last 
of those letters I mentioned that some strange 
problems with my own He had been solved by 
removing the Trans H'arp. A couple of weeks later the 
power supply in (hat computer died ( that is, nothing 
would happen when I flipped the power switch; not 
even the power-on light would come on). I replaced 
it— it happened to be one of Applied Engineering's 
heavy duty power supplies— with the computer's 
original Apple supply, put the TransWarp back in, and 
hauen't had any trouble since. Which is not to say I 
won't have troub le iomorram The computer is full of 
cards and, consequently, thepowersupplyisworking 
beyond its rated capacity. Inevitably, it will buckle 
again someday. 

The Apple 11 world badly needs a well-bulll highly- 
reliable, heavy-duty replacement power supply for 
those of us with lots of cards in our computers. We 
know of four suppliers of replacement power supplies 
for the Apple 11, but they're all selling Taiwanese 
unils that vary in quality. Open-Apple subscriber 
Don Justesen, for example, reports that some units 
have only one ground wire running to the mother- 
board, where Apple's units have two. Some have 
connectors that fail to make good contact with the 
motherboard, either because the connecting elements 
slip inside the connector or because the female 
connectors simpiy aren't fight enough. 

Most of these replacement units have higher 
ratings than Apple's original power supply and ail 
are far less expensive than exchanging a broken 
Apple supply for a rebuilt one down at your local 
Apple dealer, however, based on reports we've 
received, as well as personal experiences, toe haue to 
say thai the Taiwanese units appear to have signifi- 
cardly shorter life-spans than Apple's. Our experience 
to date indicates there's no reason to replace a 
working Apple supply with a heauy-duty Tatuianese 
replacement as a "preyentiue-mainfenance" measure, 
if you are actually experiencing problems with your 
system, however (and by "problems" I mean any 
kind ofunexptainable flakiness), the power supply is 
one of the first things you should suspect as the 
trouble-maker. 

Here's a list of the U.S. sources for replacement 
power supplies that we know about (prices were as 
of June 12). We suspect thai the quality of the units 
they sell varies from shipment to shipment, and we 
know of no way to assure that any power supply you 
buy from them Is better than a rebuilt one from 
Apple, even though the "rating" may be higher. But 
at least it will be new and it will be cheaper. 

Applied Engineering, P.O. Box 798, Carrollton, TX 
75006, 214-241-6060 has a heavy-duty supply for 
$69. BTE Computers, 14644 Caue Creek #6, 
Phoenix. AZ 85022, 602-867-8962 hasa normal-duty 
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supply for m and a heavy-duty supply for $59. 
Jameco Electronics, 1355 Shoreway M, Belmont, 
CA 94002, 415-592-8097 has a normal-duty supply 
(or $35. JDR Microdevices, 110 Knowles Dr. tos 
Gates. CA 95030, 406-866-6200, has a heavy-duty 
supply for $50. 

If any of you know of a company that can provide, 
at any price, a high-quality heavy-duty Apple II 
power supply, please let us know. 

& word processor 

I needa text editor that I can use from Applesoft. Do 
I have to write ft or can I buy a subroutine somewhere 
as a programmer's utility? 1 would lite to allow the 
user to enter/edit up to 15 lines of text (40 column 
version and 80 column version) with the features of 
insert delete, and word wrap. When the user exits the 
editor, the editor would deliver the lines (as strings) to 
my Applesoft program for filing. 

Michael Trusiewicz 
Ed Tech Systems 
68 Adelaide Avenue 
WaterburyXT 06708 

Sounds like what you want is an ampersand 
command thatwouid provide a small screen-oriented 

any such product, but our readers might 

A solution of sorts 

I really enjoyed "Sorting out sorts "in the November 
1986 issue of Open-Apple (page 2.80). I also read 
with interest the letter by Craig Wilford and your reply 
in the March issue ("Only exit POR-F1EXT at [TEXT 
page 315) in which you discussed the out of memory 
problem. The problem is that after reading this a 
reader could feel out of sorts. Modifying the sort as 
shown in March will result in improperly sorting the 
array. 

In response to your mention of the excellent 
Beagle Compiler, please let your readers know that 
there is a significant bug in all versions through 2.2 of 
the extended memory compiler (AUX5LOTSYSTEM), 
which results in abnormal functioning of the CHAIM 
command, Alan Bird has been updating this program 
almost weekly, and seems to have all the bugs ironed 
out in version 15. 1 can't recommend the program 
highly enough. 

Bruce S.Klutchko 
New York, M.Y. 

This is a case o/addingabug by trytngtofvca bug. 
it happens all the time, unfortunately. 7b summarize, 
Jim Parr's original subroutines in the November 
issue work fust find, but they break a rule about 
exiting from the middle ofaFOR-NEXTloop. lb keep 
them from breaking that rule is fairly complicated, 
but can be done, not as shown in March, but by 
changing line 940 and adding line 965: 

940 RB - : IF fi(E) T THEN AB = 1 : 
EX = E : E = El : GOTO 9S0 

9G5 IF (B - 1 THEN E = EX 

We use two new variables, AB (abort flag), and EX 
(exit value of E). We set the abort flag to ("not 
aborted"), do our comparison, and if the comparison 
succeeds we set the abort flag, save the current value 
of the loop counter in EX, set the counter to the final 
value, and GOTO the MEXT statement Line 965 has 
been added to see if we exited the loop early; if so, we 
change E back to the value it had when the decision to 
abort was made. This (finally) works, and is readable. 



Good public stuff 

Since you mentioned the public domain ProDOS 
word processor Freewriter back in May 1985 (page 
36), 1 thought you might like to know that there's a 
revision of the program called TrEDwriter, Although it 
has its limitations, FrEDwriter is better than many 
commercial word processing programs. As similar as 
it is to Apple Writer, and since it works in 40 or 80 
columns on any Apple II, and since ifs free, FrED is 
ideal for school use. Of particular note is that a 
printer control panel has been added inside the main 
program. 

Bob Garth has placed his ProTree ProDOS BBS 
system in the public domain. For anyone planning to 
startor convert to a ProDOS BBS it is worth a look. It 
was marketed commercially for awhile and is currently 
being used by a number of BBS's. 

Some shareware programs that I think have excep- 
tional merit are nifty Works, OmnifUe, and BankH. 
nifty is a DOS 3.3 word processor with a scroll speed 
of about mach L OmniJUe is an excellent DOS 3.3 
database, and BankTi is an also excellent DOS 3.3 
checkbook management program. 

If anyone wants a copy of any of these, I will 
distribute them at no cost All a person needs to do is 
send me disks for the copies, return postage, and a 
mailing label. I'll also enclose a list of 27 other 
programs that I'll distribute on the same basis. Any 
additions to the collection will be gladly accepted. 

Ed Thompson 
11768 East Atlantic Place 
Aurora, CO 80014 

Moreonelusiveness 

Regarding the comments inyourMarch issue (page 
313) on the relative speed advantage enjoyed by the 
65816 et al over the 8088-type processors: while the 
cited advantage exists, italmostcertainly has nothing 
to do with pipelining The 8088 implements pipelining 
with its prefetch cache, thus the same capability 
would bring the 65xxx-family up dead even. I tfiink the 
advantage cited by Mensch refers to the differences in 
which the processor clocks are utilized. With many 
processors, eg. the 8088 and friends, the Z-80, and 
68000, a machine cycle may take four or more dock 
cycles. The 65xxx family, inducting the older 6502, 
use only one clock cycle for each machine cyde. Thus 
a 1 MHz 6502 is effectively running as fast as a 4 MHz 
Z-80, and a 6 MHz 65C816 is matching a 24 MHz 8088 
(which doesn't exist). 

The exact nature and relationships between clock 
cydes and machine cycles is quite complex and 
variable, espedally when different microprocessors 
are involved, as in this case. Instruction cydes, as 
distinct from clock and machine cydes, complicate 
things further, 

A comparison of dock speeds atone reveals very 
little about relative performance of various processors: 
relative machine and instruction cyde speeds, bus 
bandwidths, register architectures, and instruction- 
set capabilities are more revealing. A 6 MHz 65816 is 
not the equal of a 24 MHz 68020, for instance. In 
usable performance. 

Additional factors: the type of software being run 
affects performance— code optimized by a skilled 
programmer for a 6502 may run poorly when translated 
literally for an 8086, and vice versa-A fair comparison 
might involve code optimized for each processor 

Applesoft for instance, is a poor test of a 6502, since 
the Microsoft interpreter, from which it is derived (with 



little optimization) was written for the 8080A. The 
Integer BASIC interpreter, which was written for the 
6502, is faster, deaner, and has far fewer bugs. 

F. Kuechmann 
Vancouver, Ivash. 

Corona, Rana, ProDOS 

A company called Law Industries (3387 West Coming 
St newbury Park, CA 91320, 805-498-8268) has 
developed an upgrade kit for Rana and Corona hard 
disks that allows you to add ProDOS. I am a satisfied 
customer. The kit cost me $49,95. 

Phil Hackett 
Los Angeles, Calif, 

Thanks for the tip. I just told someone last week I'd 
never heard of a ProDOS upgrade kit for Rana hard 
drives and now we have this. 

Underdevelopment 

When you see the boundng Apple on your Apple 
llgs (to get (here, boot up without any disks in your 
drives), press opeiKipple/opuWrontrol-M. 

MikeMltchelson 
Shawnee Mission, Kans. 

How that beats Inside the case any day. 

In the opinion of Uncle DOS 

I'm considering the purchase of an Apple llgs, 
Apple RGB Monitor, Epson EX-800 printer, two 3.5 
inch drives and two 5.25 inch drives, and an Applied 
Engineering gsRAM card. Who makes the cables that 
conned 6 pin circular Epson to 8 pin drcular Apple 
llgs? If the UniDisk 3,5 is intelligent and the Apple 3.5 
is dumb, does it create an advantage to buy the 
UniDisk if the Apple llgs doesn'tuse this intelligence? 
Why is it better to buy the UniDisk? mat difference is 
there between the RamFactor and gsRAM for the 
Apple llgs? I'm totally confused. Can you recommend 
other items in my setup? 

Bob Levy 
Mew York, M.Y 

I'm not familiar with the Epson printer you mention, 
but unless you are sure it can perfectly emulate an 
image Hrifer, / recommend sticking with Apple's 
printer. At least 10 per cent of the mail we get around 
here has to do with how to set up non-ImageWriter 
printers with standard Apple software, rinding a 
cable is just fhe first problem you buy when you by 
to save some money on a primer. 

The UniDisk 3.5 will work on a lie or lie The Apple 
3.5 won't The Apple 3.5 wiU work on a Macintosh. 
TTie (MiDlsk 3.5 won't If you don't have a He or a Uc 
or a Macintosh, then these points are moot On the 
llgs, the Apple 3.5 can be made to respond /aster 
than the UniDisk, using programs such as Bill 
BashamsDwersi'Cache(seeMay 1987, page 3.30). 
On the other hand, the UniDisk 3.5 can theoretically 
be turned into an Apple 3,5 by removing an internal 
togic board, but we haven't seen this done yet. The 
Apple 3.5 can never be turned into a UniDisk. 

The RamFixAor is a standard-slot card. The gsfWf 
is a card for a special memory slot inside the llgs. 
You need a minimum of 512K of memory in the 
special llgs memory slot to get the machine to do 
much of anything interesting. If it were my system, 
I'd get at teas! a megabyte of each, or the equivalent 
To pay for them I'd buy just one 3.5 and one 5.25 
drive. Let the RamFactor be your drive 2. It's bigger, 
faster, quieter, and about the same price. On the 
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downside, it requires an unused slot and needs 
some kind of electrical backup in case of power 
failure. 

1 also suggest you take a close look at the alterna- 
tives to Apple's RQB monitor. You can get a free TV 
with your system from Sony (see "RGB and TV too" 
In our March issue, page 3.13). 



Is it true that the Qgs will not handle a direct 
interface from a MIDI Keyboard to the internal syn- 
thesizer? Will desktop publishing (so prevalent on the 
Mac) come to the Ilgswith a LaserWte and Postscript? 
Is there a problem with interrupt handfing on the 
ilgs? 

John Hammond 
Greenville, Texas 

The ilgs has no built-in MIDI interface. A plug-in 
card could be (and no doubt will be) designed for the 
ilgs to connect a MIDI keyboard to the machine's 



There is no doubt that desktop publishing will 
come to the ilgs, but remember that it took three 
years for it to arrive on the Macintosh. Patience. 

I don't know of any specific problems with Ilgs 
interrupt handling. There are apparently some prob- 
iems with unclaimed interrupts (see "Insert sysiem 
disk and., ."'mow April issue, page 3.18), but they 
are shared by all Apple Us running Pro DOS 8. 

Ilgs memory manager revealed 

In regard to "Insert system disk and..." in your 
April issue- Pro DOS can't simpry ignore an unclaimed 
interrupt Since the interrupting source hasn't been 
cleared, the computer would immediatery be inter- 
rupted again. This would continue in an infinite cycle 
and the computer would hang. Asking the user if 
interrupts should be disabled is a job for an adventur- 
ous hacker type, Itwould involve swapping the screen 
somewhere while the message is displayed and 
modifying the status byte on the stack for the final FTI 
instruction. This will be tough because the interrupt 
code is very different depending on which Monitor 
ROM is being used. 

in regard to your problems with the ilgs memory 
manager's MMStartUp call ("Odd bank out' in the 
same issue, page 3.22)— the problem is that MMStart- 
Up doesn't issue new user IDs It looks to see where in 
memory the MMStartUp call was made from and 
returns the ID of the owner of that memory block. If 
you get an error, your code is in an unallocated block. 
You'd better ask the memory manager to allocate the 
area your code is in before you ask for any other 
blocks or you could wipe out your own code. 

To allocate the area you are executing in, first call 
QetMewID (tool $2003 in the miscellaneous tool set) 
to get a user ID. Use that ID with Mewflandle (tool 
$0902 in the memory manager tool set) to allocate 
the memory you need. When your application is 
finished, call DisposAll (tool S1102 in the memory 
manager tool set) to deallocate your memory, and 
DeletelD (tool $2103 in the miscellaneous tool set) to 
release your ID back to the system. 

Contrary to popular belief, MMStartUp doesn't 
issue ID numbers. Likewise, MMShutDown doesn't 
free up the memory blocks you allocate (no, this is not 
a bug). 

Rich Williams 
Apple Computer, Inc 

There you have it folks, from the author of the Ilgs 



memory manager himself. While from ProDOS 8 the 
MMStartUp call appears to be a massive Catch-22 
(you're not supposed to ask for memory until you've 
started up the memory manager, yet you can't 
successfully start the memory manager untii you 
own a hunk of memory), from ProDOS 16 It makes 
more sense. Under ProDOS IS the System Loader 
will have already allocated your application's memory, 
so instead of retumingan error, MMStartUp tells your 
application what its user ID is. Under ProDOS 16 it 
appears that MMStartUp Is assigning the ID, but in 
fact the System Loader has already gotten the ID for 
you from the ID manager and has gotten your 
memory for you from the memory manager. Under 
ProDOS 8, on the other hand, you have to do all this 
stuff yourself. In return, under ProDOS 8, MMStartUp 
and MMShutDown are "do-nothing" commands that 
you can ignore. 

The essential synta* for making a Ilgs tool call was 
published here in Time to look in the toolbox" In our 
April issue, page 3.21 

The GetNewlD call (LDX #$2003) requires that 
you push two byles on the stack for a result and two 
bytes specifying the type of ID you are requesting. 
Here are the possible types you can request 



memory manager 
11000 = application 
E000 = control program 
I39B0 . ProDOS 

- tool sets 
15000 - desk accessories 
3G000 = runtime libraries 
$7000 = system Loader 



firmware 
J900B = tool locator 
W000 = setup file 
JB000 = undeFinBd 
$CM0 - undefined 
10000 = undefinsd 
%Vm = undefined 
iFm = undefined 



Obviously, $1000 is the type of ID folks like us will 
use most of the time. The call wiU return a 2-byte ID. 
The high byte will contain the ID type you have 
requested, the tow byte will contain a number 
between $01 and $fT. The two bytes combined give 
you a unique user ID. Since there are a limited 
number of possible ID numbers, its necessary that 
you call DeletelD when your program is finished. If 
you don't and somebody runs your program a 
number of times in succession without coid-starting 
the system, there wlli eventually be no ID numbers 
left and QetflewID will return its only possible error, 
$Q30B (no IDs left). DeletelD (LDX #$2103) requires 
that you push your 2-byte ID on the stack before 
calling it. It returns nothing and never generates an 
error. 

The low nibble of the high byte (for those of you 
whose eyes just glazed over, this means the digit 
with the V in it in $0x00) is called the "aux ID field." 
You can use it when you request memory from the 
memory manager to assign your memory blocks up 
to 16 of your own ID numbers. If you need more 
memory blocks than that youcould group them into 
16 types— you can request as many blocks as you 
want using each ID. (You can also just leave the aux 
ID set to zero all the time and forget you ever heard 
about it. /suspect it is about as useful to mostofusas 
a write-proted tab.) 

You allocate yourself a block of memory, once 
you have your ID, by calling Hewflandle (LDX 
#$0902). To use this tool, push 4 bytes for a result, 4 
bytes specifying the size of block you want your 2- 
byte user/O, a 2-byte memory attribute byte (details 
upcoming), and a 4-byte address specifying where 
in memory you want the block to be (even If you 
don't care where the block ends up you have to push 
4 garbage bytes here). The call can return three 
errors— $0201 unable to allocate this block; $0204, 
illegal operation on a fixed or locked block: and 



$0207, Invalid user ID. 

The call returns a 4-byte "handle." Sane this, it's a 
fixed location in the Ilgs memory that will always 
point to the beginning of your memory block. The 
memory manager doesn't return the actual address 
of your block because if it later had to move it the 
address itgaveyou would be wrong. Instead, itgives 
youthe address of a pointer that will never move and 
promises to update that pointer with the latest 
address of your memory block every time it moves 
things around. 

An interesting bit of trivia isthatthe word "ha ndie" 
was handed down to the Hgs development team 
from the Macintosh development team. The Mac 
team named handles after one flam Handle, who 
was a permanent resident of towa City, Iowa In the 
late 1800s. Handle became famous for knowing the 
current address of everyone in south-eastern Iowa. 
Whenever people wanted to know where someone 
was living they would ask Har» .^for the current 
address. 

The 2-byte memory attribute specifies the prop- 
erties of the memory block you want the memory 
manager to allocate. To make things simple, think of 
the attribute as four hex digits called $ABCD. 

The A digit can be set to two interesting values. A 
zero indicates that yo u are willing toletthe memory 
manager move your block of memory around, at 



wantyour block to be moved. You should try to use a 
here as much as possible. Machine language 
instructions that aren't written to be relocatable, 
however, will have to be placed in blocks that are 
fixed "by means of a4 here. (The high bit of this digit 
indicates whether or not the block is "locked." Well 
talk about this later.) 

The B digit is the "purge" level of your block. This 
can be a number between and 3. AO means the 
block cannot be purged by anything except a Dispos- 
flandle or DisposAll tool call (upcoming), tor the 
time being, stick with a zero here. If you use a lor 2 
(3 is reserved for the System Loader, alt 2s will be 
purged before any Is) and the memory manager 
needs some memory, It may borrow your block. In 
this case, the block's handle will be set to all zeros, or 
nil. If you need to use the block again later and find a 
nil handle where you expected an address, you have 
to use a tool called HeAliocHandle to get the block 
reallocated and then reload it with whatever data it 
held (you had it sawed on a disk somewhere, didn't 
you?) 

The C digit can only be or I at least for now. A 
indicates the block may cross a bank boundary. A 1 
indicates it may not. 

The four bits of the D digit are best handled 



The 8s bit indicates whether or not the memory 
block can use "special" memory (0=yes, l=no). 
Special memory includes a/I of banks $00, $01 and 
the video screen areas of banks $EO and $EL 

The 4s bit indicates whether the memory block 
needs to be "page-aligned" (0=no, l=yes). Page- 
aligned means the last two hex digits of the address 
are zero. Forhighly technical reasons, page alignment 
is needed with any machine code that includes 
tlmingloops. 

The 2s bit indicates whether the memory block 
needs to be at a certain, specific address (O=no, 
l=yes). The 4-byte address you push on the stack 
before calling riewHandle Is ignored unless you set 
this bit or the next one to 1 If this bit is I all four 
bytes of the address you specify are used. Based on 
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release specified Mocfcs o/ your memory without 
your Waning to give up their handles. What they're 
good for escapes me. The -M commands, incidentally, 
are sensitive to the aux id you pass to them. If the 
awe ID digit you give is 0, then the action occurs 
regardless of what the awe ID digits of your memory 
Mocks are. If the auxIDyougive is not 0, on the other 
hand, then the action occurs only to your blocks that 
have that aux ID. 

GetHandleSize returns the size of a specified 
block, SethandleSize changes the size of a specified 
block, CompadMem causes the memory manager 
to move those things that are movable around In an 
effort to maximize the largest block of free space, 
FreeMem returns the total number of free bytes in 
memory, MaxBlock returns the size of the largest 
block currently available (use CompatWem first to 
find the largest block possible), and TbtalMem returns 
the size, of all memory in the llgs, including the main 
256K. 

HLock, UUnLock, HLockAlL and HUnLockAll are 
used to change the "lock" status of specified blocks. 
A locked block has the high bit oftheA-digit set to 1 
When a block Is locked, it can neither be purged nor 
moved. Note that when a Mock has its purge level in 
the B-digif set to and the "fixed-location" bit of the 
A-digit set to I it is as good as locked whether it Is or 
not. The lock commands are primarily used to 
temporarily fix the position of a block you originally 
defined as movable. For example, any relocatable 
machine code that's in a movable block should lock 
its position before using HewHandle, ReAlloctiandle, 
SetffandteSize, or CompactMem. Otherwise, the 
code could pull the rug out from under Itself, which is 
a sorry thing to see, indeed. 

SetPurge and SetPurgeAU attow you to change the 
B-digit purge level of a block. BlockMove, PtrTbfland, 
MandToPrt, and HandTbtland are four tools that 
allow you to move a specified number of bytes from 
a source address to a destination address, Tnat's all 
there is to the memory manager. Space prohibits 
going Into more detail on most of these tools. The 
only two tools you really need to know about to get 
started, however, arefiewiiandle and DisposAll. 

DisposAll (WX#$U02) requires one 2-byte input 
the user ID whose handles will be discarded. It 
returns nothing and has only one error, $0207, 
invalid user ID. This command ignores both the 
purge level and the lock status of a block -its 
purpose in life is to clean out the memory you've 
been using when you're ready to quit If the aux ID Is 
0, every block belonging to you will be discarded. If 
the aux ID is set to anything else, however, only 
blocks with thespecified auxlD will be effected. After 
using DisposAll don't forget to also use Delete©. 

If you would like to experiment with these com- 

the llgs that you should know about It's a desk 
accessory that Williams wrote. To start if up, do this: 

]CflLL -151 



address, its attributes, its ID, and its size, have fun 
Be forewarned, however, that Williams uion'tpromise 
that this educational tool willbe infuture revisions of 
the llgs ROMs, so use it to leant how the memory 
manager works now, while you have the chance. 

Reboot, cold reboot, frigid reboot 

. ..There's also away to get the llgs memory manager 
to give you some memory without a user ID. It took 
me awhile to pry it out of Rich Williams, and he told 
me the secret only after making me promise not to 
useitaboutfourtimes.Allyou need to do is use the ID 
£0001 This is the ID of the memory manager itself, 
which is always active. Using this ID means the 
memory you get is never de-allocated, even after a 
control/open-apple/reset cold-boot. Only a power-off 
reboot can reclaim the memory. 

do a power-off reboot without turning the power off. 
Remember all those worn out power switches on the 
H-PIus? The He's control/open-apple/reset was sup- 
posed to eliminate that problem, but on the llgs, 
Apple wanted the RAMdisk to live through a reboot 
You may have noticed that most of the control-panel 
stuff either takes effect immediately or it takes effect 
after a control/open-apple/reset But if you change 
the control-panel RAMdisk settings, nothing changes 
until a complete power-down of the system. 

To accomplish this, Apple added a new power-up 
byte and tucked it into the RAM that belongs to the 
keyboard microprocessor. This is the RAM that holds 
the keyboard type-ahead buffer, among other things. 
Byte $51 is the power-up byte. Here's how to trash it 
and force control/open-apple/reset to destroy and 
reallocate the RAMdisk along with everything else: 

CALL -151 
0:51 

As a machine language routine it would be: 

CLC 
XCE 

REP «3» 

LDA M08S1 

STH 10800 

FEB 10002 

PEA SB000 

PEP S8MB 

PEP S000B 

LDX IU0909 

JSL JE10000 
SEC 

as 

RTS 

One last llgs goodie for you. How do you tell you're 
in a llgs? Apple suggests a rather long machine 
language routine. However, I propose using an easier 
way as follows: 



tests I've done so far, there doesn't seem to be any 
way to request for example, the area from $2000 to 
$4000 while saying that you don't care what bank 
you get Such an ability would be handy for certain 
types of non-relocatable code, so I may be mistaken 
about this. 

The Is bit indicates "fixed bank" (O=no, l~yes). 
However, on tests I've done, it only seems to work 
when both the special-memory bit and the bank byte 
of the four-byte address are cleared to 0. fn that case, 
youU get a memory block somewhere in bank $00. 
If the bank byte of the four-byte address is set to 
anything other than $00, this bit seems to have no 
effect on what bank youget. I'd sure like to hear that 
someone replicated this experiment, however, 

note the difference between the fixed-address and 
fixed-bank bits of the D digit and the fixed-locationbit 
of the A digit. The D&git bits haue to do with where 
the memory manager puts the memory block when 
it allocates iv/w, 'tethe A-digit bit has to do with 
whether or n)ef ^.TiOry manager has permission 
to move the b c ;aviater. If you set either of the D-digit 
bits to 1 you should also set the A-digii bit so that the 
block you've so carefully specified doesn't get 
moved elsewhere later. 

The memory manager provides a variety of 
tools for manipulating memory blocks, once you've 
allocated them. We've already touched on ReAUoc- 
tiandle, Dispostfandle, and DisposAU. furgeflandie 
and PurgeAU will force the memory manager to 



*0=e (must ha a InusrcasE *b") 
*FF/lB00x 



How press open-apple/control/escape to see the 
desk accessory menu. YouU see a new item called 
"Memory Peeker." Select it It wUl put a one-line 
menu at the top of your screen. Press "U" to see the 
blocks that the memory manager has allocated (you 
may haiie to press ctrl-S to keep them from scrolling 
out of sight). YouU see each block's handle, its 



IF PEEK(-l) - 192 THEM you're in an RpplE llgs 

The location contains the high byte of the interrupt 
vector. On the llgs, the interrupt vector points to 
SC074, which contains some special ROM that exists 
only in the llgs. The H-Plus, lie, and lie computers 
have no ROM in page $C0. And I suspect ifs unlikely 
that the llgs interrupt vector will move in future 
versions since it's very hardware dependent 

Bill Basham 
Diversified Software Research 
Farmington, Mich. 
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